home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / games / addons / rm110.arj / SCSI / FDCDTEST.TXT < prev    next >
Text File  |  1993-10-13  |  12KB  |  385 lines
  1.  
  2. ABOUT FDCDTEST
  3. ==============
  4.  
  5.  
  6.  
  7. PRODUCT DESCRIPTION
  8. -------------------
  9.  
  10. The CD-ROM test utility was designed to test the integrity of the Future 
  11. Domain CD-ROM Device Driver and CD-ROM drives.  Users and Developers will 
  12. now be able to test all the functions supported by the CD-ROM Driver for 
  13. problems related to the CD-ROM Driver or the CD-ROM drive itself.
  14.  
  15. This utility is also used in the Future Domain Quality Assurance Test 
  16. Procedure for each drive supported by the Future Domain CD-ROM Driver.  
  17. This is performed to ensure that every available function is operational 
  18. for use with the CD-ROM applications on the market as well as future CD-ROM 
  19. applications.  FDCD test is written to the Microsoft CD-ROM Extensions.  
  20. For a complete description of all the functions supported by the Microsoft 
  21. CD-ROM Extensions, you may contact Microsoft Corporation for a copy.
  22.  
  23.  
  24.  
  25. TO START FDCDTEST
  26. -----------------
  27.  
  28. To run the FDCDTEST program change directory to where the FDCDTEST.COM file 
  29. is and at the DOS prompt type the following:
  30.         
  31.         fdcdtest <Enter>
  32.    
  33. The program locates all CD-ROM drives within the system attached to the 
  34. Future Domain SCSI Controller(s) and prompts for a drive selection.
  35. You need to select a CD-ROM drive to test.
  36.  
  37. The Main menu is then displayed.
  38.  
  39. FDCDTEST will abort if the following conditions occur:
  40.  
  41.   The CD-ROM Extensions are not installed.
  42.   No CD-ROM drives found attached to the Future Domain SCSI Controller.
  43.  
  44. There are three Function Menus available. These are:
  45.  
  46.    Main Menu
  47.    IOCTL Input Menu
  48.    IOCTL Output Menu
  49.  
  50. To minimize the screen output, the menus are displayed only once.  You may 
  51. press the ? key to re-display a menu.
  52.  
  53.  
  54.  
  55. FUNCTION MENUS
  56. --------------
  57.  
  58.  
  59. Main Menu
  60. ---------
  61.  
  62. This menu is displayed upon startup of the program.  Pressing the <Enter> 
  63. key from this menu will cause the program to terminate.
  64.  
  65. Following are the descriptions of the options available from the Main menu.
  66.  
  67. 0 - IOCTL INPUT
  68.  
  69. Choose this option to select an IOCTL Input option from the IOCTL Input Menu.
  70.  
  71. 1 - INPUT FLUSH
  72.  
  73. Clears all input buffers and pending requests in the Device Driver.
  74.  
  75. 2 - IOCTL OUTPUT
  76.  
  77. Choose this option to select an IOCTL Output option from the IOCTL Output 
  78. Menu.
  79.  
  80. 3 - DEVICE OPEN
  81.  
  82. Used by the Dvice Driver to determine the number of callers that are 
  83. currently using the CD-ROM Device Driver.
  84.  
  85. 4 - DEVICE CLOSE
  86.  
  87. Used by the Device Driver to determine the number of callers that are 
  88. currently using the CD-ROM Device Driver.
  89.  
  90. 5 - READ LONG
  91.  
  92. A SCSI Read command is issued to the CD-ROM drive with the option of 
  93. specifying the Addressing Mode and the Data Read Mode.
  94.  
  95.     Addressing        0 - High Sierra Mode
  96.     Modes:
  97.                       1 - Red Book mode
  98.  
  99.     Date Read         0 - Cooked mode : usually the
  100.     Modes:                default mode for EDC/ECC
  101.                           checking which returns a block
  102.                           size of 2048 bytes.
  103.                       1 - Raw mode - for no EDC/ECC
  104.                           checking, this option returns all
  105.                           2352 bytes which includes the
  106.                           EDC/ECC data.
  107.  
  108. 6 - READ LONG PREFETCH
  109.  
  110. Same as READ LONG but no data is transferred.
  111.  
  112. 7 - SEEK
  113.  
  114. A SCSI Seek command is issued to the CD-ROM drive with the option of 
  115. specifying the Addressing Mode.
  116.  
  117.     Addressing        0 - High Sierra mode
  118.     Modes:
  119.                       1 - Red Book mode
  120.  
  121. 8 - PLAY AUDIO
  122.  
  123. This function is used to play a selected track on an audio disc.
  124.  
  125.     Track Number:        Any valid track on an audio disc.
  126.     Play to end of disc: This gives you the option to either play to
  127.                          the end of the disc or just the specified
  128.                          track.
  129.  
  130. 9 - STOP AUDIO
  131.  
  132. This function is used to pause or stop a CD-ROM drive while in Play mode.  
  133. Selecting this option once will put the drive in Pause mode and selecting 
  134. this option twice consecutively will put the drive in the Stop mode.
  135.  
  136. A - RESUME AUDIO
  137.  
  138. This function is used to restart Play mode on a CD-ROM drive currently in 
  139. Pause mode.  A "General Failure" error status will occur if the drive is 
  140. in Stop mode.
  141.  
  142. B - DISPLAY DEVICE STATUS
  143.  
  144. The Device status is a 2-byte value which is returned by the device driver 
  145. to indicate the command request has successfully been completed.  This 
  146. function displays Bit 8 and 9 of this status which corresponds to the Done 
  147. and Busy bit.
  148.  
  149.  
  150. IOCTL Input Menu
  151. ----------------
  152.  
  153. The IOCTL Input menu is displayed by selecting option 0 from the Main menu.  
  154. Press the <Enter> key to return to the Main menu.  The following section 
  155. describes the options available from the IOCTL Input menu.
  156.  
  157. 0 - RETURN DRIVER ADDRESS
  158.  
  159. A 4-byte address is displayed indicating where in the system memory the 
  160. CD-ROM driver is located.
  161.  
  162. 1 - LOCATION OF HEAD
  163.  
  164. Displays the current location of th drive head in High Sierra and Red Book 
  165. format.
  166.  
  167. 2 - AUDIO CHANNEL INFO
  168.  
  169. Use to display the current Audio Channel control settings. These settings 
  170. may be changed using the Audio Channel Control IOCTL Output function.
  171.  
  172. There are a total of 4 input and output channels that may be supported by 
  173. a CD-ROM drive.  Valid channels are 0 to 3 which represent the following:
  174.  
  175.    Channel 0:            Front left
  176.    Channel 1:            Front right
  177.    Channel 2:            Rear left
  178.    Channel 3:            Rear right
  179.    Input Channel:        This is the actual channel that is read
  180.                          from an Audio track on a disc.
  181.    Output Channel:       This is the channel that comes from
  182.                          the drive's amplifier to power the
  183.                          speakers.
  184.    Volume Control:       A value from 0 to 255 indicating the
  185.                          volume setting on the specified
  186.                          channel.  A volume control of 0
  187.                          indicates Mute mode and a volume
  188.                          control of 255 indicats Full volume.
  189.  
  190. 3 - DEVICE STATUS
  191.  
  192. The device status is maintained by the CD-ROM driver to provide a general 
  193. description of the options currently set and available on the CD-ROM drive. 
  194. The device status is maDe up of 32 bits which are defined as follows:
  195.  
  196.    Bit 0:     0 -  Door closed
  197.               1 -  Door open
  198.    Bit 1:     0 -  Door locked
  199.               1 -  Door unlocked
  200.    Bit 2:     0 -  Supports only cooked reading
  201.               1 -  Supports cooked and raw reading
  202.    Bit 3:     0 -  Read only
  203.               1 -  Read/write
  204.    Bit 4:     0 -  Data read only
  205.               1 -  Data read and plays audio/video tracks
  206.    Bit 5:     0 -  No interleaving
  207.               1 -  Supports ISO-9660 interleaving
  208.                    Using interleave size and skip factor
  209.    Bit 6:     0 -  Reserved
  210.    Bit 7:     0 -  No prefetching
  211.               1 -  Supports prefetching requests
  212.    Bit 8:     0 -  No audio channel manipulation
  213.               1 -  Supports audio channel manipulation
  214.    Bit 9:     0 -  Supports HSG addressing mode
  215.               1 -  Supports HSG and red book addressing modes
  216.    Bit 10:    0 -  Reserved
  217.    Bit 11:    0 -  Disc is present in drive
  218.               1 -  No disc is present in drive
  219.    Bit 12:    0 -  Does not support R-W sub-channels
  220.               1 -  Supports R-W sub-channels
  221.    Bit 13-31: 0 -  Reserved
  222.  
  223. 4 - RETURN SECTOR SIZE
  224.  
  225. The driver will return a cooked sector size of 2048 bytes and a raw sector 
  226. size of 2352.
  227.  
  228. 5 - RETURN VOLUME SIZE
  229.  
  230. This function returns the lead-out track which corresponds to the total 
  231. number of blocks on the disc.  The displayed address is in High Sierra 
  232. format.
  233.  
  234. 6 - MEDIA CHANGED
  235.  
  236. This function is used to determine the current media state of the drive.  
  237. The returned values are defined as follows:
  238.  
  239.    1  media not changed
  240.  
  241.    0  don't know if changed
  242.  
  243.   -1  media changed
  244.  
  245. 7 - AUDIO DISC INFO
  246.  
  247. Displays the first and last track of an audio disc.  The lead-out address 
  248. is also displayed in Red Book format.
  249.  
  250. 8 - AUDIO TRACK INFO
  251.  
  252. Displays the starting Red Book address for each track found on the disc.
  253.  
  254. 9 - AUDIO Q-CHANNEL INFO
  255.  
  256. This function returns the current track number and the running time within 
  257. the track and disc in Red Book format.
  258.  
  259. A - UPC CODE
  260.  
  261. Use this option to get the UPC/EAN (Universal Product Code) from the disc.  
  262. Most discs do not contain this code and will cause the driver to return a 
  263. "Sector not Found" message.  Also, if the CD-ROM drive does not support 
  264. this function, an "Unknown Command" message will be returned by the driver.
  265.  
  266. B - AUDIO STATUS INFO
  267.  
  268. After selecting an audio track to play, this function will display the 
  269. starting and ending addresses specified by the play request. Will also 
  270. display the Pause status of drive.
  271.  
  272.  
  273. IOCTL Output Menu
  274. -----------------
  275.  
  276. The IOCTL Output menu is displayed by selection Option 2 from the Main menu.  Press the Enter key to return to the Main
  277. menu.  The following section describes the options available from the IOCTL 
  278. Output menu.
  279.  
  280. 0 - EJECT DISC
  281.  
  282. Use this function to eject a disc from the CD-ROM drive.  If the drive door 
  283. is locked, the driver will unlock the door before ejecting.
  284.  
  285. 1 - LOCK DOOR
  286.  
  287. This function will lock the door on a CD-ROM drive.
  288.  
  289. 2 - UNLOCK DOOR
  290.  
  291. This function will cause the drive to unkock the door if previously locked.
  292.  
  293. 3 - RESET DRIVE
  294.  
  295. Use this function to reset and reinitialize the drive.
  296.  
  297. 4 - AUDIO CHANNEL CONTROL
  298.  
  299. This function displays the current Audio Channel control settings and 
  300. prompts for an Input and Output channel and a Volume control setting for 
  301. the specified channel.  See "IOCTL Input Audio Channel Info" option for 
  302. additional information.
  303.  
  304. 5 - CLOSE TRAY
  305.  
  306. This function will close the tray on a CD-ROM drive that employs a tray 
  307. mechanism.
  308.  
  309.  
  310.  
  311. ERROR MESSAGES
  312. --------------
  313.  
  314. The CD-ROM driver returns a Status code for every command request that is 
  315. completed.  This code is used to indicate whether the command request was 
  316. completed successfully or if an error occurred.  In the event of an error, 
  317. the driver will set the Error bit (bit-15) in the status code and will 
  318. place the error code in bits 0-7.
  319.  
  320. If an error occurs when using this utility, the program will automatically 
  321. convert the error code to one of the following error messages.
  322.  
  323. Error Code:   Error Messages:
  324.  
  325.   0           Write protect violation
  326.   1           Unknown unit
  327.   2           Drive not ready
  328.   3           Unknown command
  329.   4           CRC error
  330.   5           Bad drive request structure length
  331.   6           Seek error
  332.   7           Unknown media
  333.   8           Sector not found
  334.   9           Printer out of paper
  335.   10          Write fault
  336.   11          Read fault
  337.   12          General failure
  338.   13          Reserved
  339.   14          Reserved
  340.   15          Invalid disc change
  341.  
  342.  
  343.  
  344. COMMAND CODE TABLE
  345. ------------------
  346.  
  347. The following table shows the menu selection codes as corresponding to the 
  348. Microsoft CD-ROM Extensions command codes.  The numbers in brackets are the 
  349. IOCTL command sub-codes.
  350.  
  351.   FDCDTEST Menu
  352.   Selection Codes      CD-ROM Extensions Codes
  353.  
  354.   0-[0]    3-[0]       ADDRESS OF DEVICE DRIVER
  355.   0-[1]    3-[1]       LOCATION OF HEAD
  356.   0-[2]    3-[4]       AUDIO CHANNEL INFO
  357.   0-[3]    3-[6]       DEVICE STATUS
  358.   0-[4]    3-[7]       RETURN SECTOR SIZE
  359.   0-[5]    3-[8]       RETURN VOLUME SIZE
  360.   0-[6]    3-[9]       MEDIA CHANGED
  361.   0-[7]    3-[10]      AUDIO DISC INFO
  362.   0-[8]    3-[11]      AUDIO TRACK INFO
  363.   0-[9]    3-[12]      AUDIO O-CHANNEL INFO
  364.   0-[A]    3-[14]      UPC CODE
  365.   0-[B]    3-[15]      AUDIO STATUS INFO
  366.   1        7           INPUT FLUSH
  367.   2-[0]    12-[0]      EJECT DISC
  368.   2-[1]    12-[1]      LOCK DOOR
  369.   2-[2]    12-[1]      UNLOCK DOOR
  370.   2-[3]    12-[2]      RESET DRIVE
  371.   2-[4]    12-[3]      AUDIO CHANNEL CONTROL
  372.   2-[5]    12-[5]      CLOSE TRAY
  373.   3        13          DEVICE OPEN
  374.   4        14          DEVICE CLOSE
  375.   5        128         READ LONG
  376.   6        130         READ LONG PREFETCH
  377.   7        131         SEEK
  378.   8        132         PLAY AUDIO
  379.   9        133         STOP AUDIO
  380.   A        136         RESUME AUDIO
  381.  
  382.  
  383.  
  384.  
  385.